Skip to content

Conversation

@SukanyaDas-MSFT
Copy link
Collaborator

No description provided.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.


## Calculate performance metrics for apps

Identifying existing apps with low performance to drive them to adapt best practices is crucial for improving app performance. The **Self-Serve Lightweight Audit Tool** allows you to analyze and optimize app performance on Android and iOS mobile platforms.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the tool is primarily to be used by the app developer themselves to identify performance issues (and not, say, identify all apps with perf issues)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it helps developers assess the performance of their apps:

  1. in absolute terms
  2. in relative terms by benchmarking the same against recommended values (as per Microsoft and/or industry)

Copy link
Collaborator Author

@SukanyaDas-MSFT SukanyaDas-MSFT Oct 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rephrased to read:
Identifying new or existing apps with low performance for compliance with best practices is crucial for operational effectiveness. The Performance Report (or Perf Report) tool not only allows you to assess performance of your mobile apps in absolute terms; but also helps you compare performance across different apps by benchmarking against recommended values. It's a self-serve, lightweight tool that can be run directly on your mobile (Android and iOS).

Please check for technical accuracy.


To generate performance metrics via **Self-Serve Lightweight Audit Tool** for your mobile app, follow these steps:

1. On your Teams app, go to **Settings** > **About** > **Developer preview** and toggle the switch to enable **Developer preview**.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thought: double check if steps and menu items are same on Android and iOS

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pls call out "Teams mobile app"

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thought: double check if steps and menu items are same on Android and iOS

@tanya23696, We could not test in iOS as the feature was not released when we tested. Please let us know if deployment has been completed on iOS.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pls call out "Teams mobile app"

Done


### Analyze performance metrics report

The performance metrics report contains the following metrics.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

entire table seems to have picked up content directly from the PRD - these were written as requirements.
For the tech documentation, these will have to rephrased for easier understanding by the user (developer), without changing the meaning.
Let's iterate on this entire table

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @tanya23696,

Shared the revised content for the table, please let me know if anything else needs to be added/revised.

Thanks.

@microsoft-production-github-app

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@microsoft-production-github-app

Acrolinx Scorecards

We currently enforce a minimum score of 80.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Score Issues Scorecard Processed
msteams-platform/resources/teams-mobile-best-practices.md 92 17 link

More info about Acrolinx

Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally.

@learn-build-service-prod
Copy link
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 776c9a4:

✅ Validation status: passed

File Status Preview URL Details
msteams-platform/assets/icons/generate-report-icon.png ✅Succeeded View
msteams-platform/assets/icons/kebab-icon.jpg ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/android-entry-point.jpg ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/app-audit-report-app-package.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/app-audit-report-caching.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/app-audit-report-content-paint-metrics.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/app-audit-report-disk-size.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/calculating-metrics.jpg ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/files-affecting-bundle-size.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/latency-not-calculated.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/notify-success-called.jpg ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/performance-report-success-bottom-sheet.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/performance-report.png ✅Succeeded View
msteams-platform/assets/images/tabs/lightweight-audit-tool/self-serve-lightweight-developer-preview-toggle.jpg ✅Succeeded View
msteams-platform/resources/teams-mobile-best-practices.md ✅Succeeded View

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants